Chuyển tới nội dung chính

Tạo Seller

Đường dẫn​

  • URL: /cb-core/api/v1/seller/create
  • Method: POST
  • Mô tả: API cho phép đăng ký thông tin seller mới vào hệ thống Baokim

Request​

Bảng Request​

Tham sốKiểu dữ liệuBắt buộcMô tả
request_idstring(50)CóRequest ID từ merchant.
Định dạng: MerchantCode + YYYYMMDDHHMMSS + UniqueId
request_timestring(19)CóThời gian request. Định dạng: YYYY-MM-DD HH:MM:SS
merchant_codestring(20)CóMerchant code được cung cấp bởi Baokim
sub_merchant_codestring(20)CóMã sub-merchant. Nếu seller trực thuộc merchant, điền merchant_code
seller_idstring(50)CóMã Seller trong hệ thống merchant
seller_namestring(255)CóTên đầy đủ của seller
platformarrayCóThông tin nền tảng
- typestringCóLoại nền tảng:
1: Website
2: Nền tảng Thương mại điện tử
3: B2B
4: Dịch vụ
5: Khác
- linksstring(255)Có*URL nền tảng (*Bắt buộc nếu type là 1 hoặc 2)
- platform_seller_idstring(255)Có*Mã Seller trên nền tảng (*Bắt buộc nếu type là 2)
filesarrayCóCác tệp tài liệu (tối đa 15 tệp)
- typestringCóLoại tệp:
1: Giấy phép kinh doanh
2: CMND/Hộ chiếu/Visa
3: Hợp đồng
4: Báo cáo Ngân hàng
5: Khác
- filefileCóTải lên tệp (jpg, jpeg, png, pdf, tối đa: 2MB)
representative_DOBstringCóNgày sinh của đại diện (Định dạng: YYYY-MM-DD)
representative_ID_numberstring(255)CóSố ID của đại diện
representative_namestring(255)CóTên đầy đủ của đại diện
representative_nationalitystring(255)CóQuốc tịch của đại diện
representative_addressstring(255)KhôngĐịa chỉ của đại diện
seller_business_typestringCóLoại hình kinh doanh:
1: Doanh nghiệp
2: Hộ kinh doanh
3: Cá nhân
seller_business_registration_nostring(255)Có*Số đăng ký kinh doanh (*Bắt buộc nếu business_type là 1 hoặc 2)
seller_phonestringKhôngSố điện thoại liên hệ
seller_emailstringKhôngEmail liên hệ (phải là định dạng email hợp lệ)
seller_business_descriptionstring(255)CóMô tả kinh doanh
seller_risk_levelstringCóMức rủi ro:
1: Thấp
2: Trung bình
3: Cao
gc_codestring(10)CóMã nhóm danh mục (phải tồn tại trong hệ thống) Tải excel
mcc_codestring(10)CóMã danh mục Merchant (phải tồn tại trong hệ thống) Tải excel

Ví dụ Request​

{
    "request_id": "MERCHANT12345678901234510281",
    "request_time": "2024-11-15 14:36:00",
    "merchant_code": "MERCHANT001",
    "sub_merchant_code": "MERCHANT001",
    "seller_id": "SELLER123456",
    "seller_name": "Nguyễn Văn A",
    "platform": [
        {
            "type": "2",
            "links": "https://shopee.vn/seller123",
            "platform_seller_id": "SHOPEE123456"
        }
    ],
    "files": [
        {
            "type": "1",
            "file": "[binary file data]"
        },
        {
            "type": "2",
            "file": "[binary file data]"
        }
    ],
    "representative_DOB": "1990-01-01",
    "representative_ID_number": "001099012345",
    "representative_name": "Nguyen Van A",
    "representative_nationality": "Vietnam",
    "representative_address": "1 Dai Co Viet Street, Hai Ba Trung District, Ha Noi",
    "seller_business_type": "2",
    "seller_business_registration_no": "0123456789",
    "seller_phone": "0912345678",
    "seller_email": "[email protected]",
    "seller_business_description": "Online retail store selling electronics",
    "seller_risk_level": "1",
    "gc_code": "5045",
    "mcc_code": "5399"
}

Response​

Bảng Response​

Tham sốKiểu dữ liệuMô tả
response_codeintMã phản hồi từ Baokim
response_messagestring(255)Mô tả phản hồi
merchant_codestring(20)Mã Merchant
seller_idstring(50)Mã Seller
statusintTrạng thái Seller:
1: Đang xử lý

Ví dụ Response​

{
    "response_code": 200,
    "response_message": "Success",
    "merchant_code" :"MERCHANT001",
    "seller_id": "SELLER123456",
    "status": 1
}

Mã Lỗi​

Mã ResponseThông báo ResponseMô tả
200Thành côngTạo seller thành công
101Lỗi Hệ thốngLỗi hệ thống
422Lỗi xác thựcLỗi xác thực
130Seller ID tồn tạiMã Seller bị trùng lặp hoặc đã tồn tại